home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / wb / czesc_3 / multireset / doc / multireset.dok < prev    next >
Text File  |  1995-12-04  |  7KB  |  174 lines
  1. MultiReset 3.0ß                Dokumentation                     04.12.1995
  2. ---------------------------------------------------------------------------
  3.  
  4. Ja,   manchmal   ist   er   notwendig,   der   Reset.    Ausgeloest   ueber
  5. CTRL+LAMIGA+RAMIGA  fuehrt er zu einem Neustart des Systems.  Aber muss der
  6. Reset   immer   so   langweilig   sein?   Neuere  Amigamodelle  bieten  die
  7. Moeglichkeit, Resethandler einzubinden, die nach Ausloesung des Resets noch
  8. bestimmte  Dinge  erledigen.   Das  ist  ein Fall fuer MultiReset.  Es kann
  9. Sounds  abspielen,  Grafiken  zeigen  oder auch nuetzliche Sachen, wie z.B.
  10. die Vektoren auf Null setzten oder ein Dos-Kommando ausfuehren.
  11.  
  12. Ausgeloest  wird der Reset entweder ueber den "Affengriff" oder, jetzt Neu,
  13. ueber  ein  Rexx-Kommando.   Der Rexxport heisst 'Multireset' und es werden
  14. zwei Kommandos unterschieden:
  15.  
  16.   - RESET       - Fuert MultiReset mit allen Optionen aus
  17.   - RESET QUICK - Fuehrt einen sofortigen Reset aus
  18.   - REMOVE      - Entfernt MultiReset aus dem Speicher
  19.  
  20. Ein Reset ueber Arexx koennte so aussehen:
  21.  
  22.     address 'MultiReset';RESET
  23.  
  24. MultiReset  benoetigt  mindestens Kickstart 37.175.  Das Programm sollte in
  25. die  "startup-sequence"  oder  besser  in  die  "user-startup"  eingebunden
  26. werden.  Zum Beispiel:  Run >NIL:  MultiReset.  Natuerlich kann man es auch
  27. wunderbar in der WBStartup unterbringen :)
  28.  
  29. Hinweis: MultiReset laeuft nicht auf aelteren A500 oder A2000-Rechnern.
  30.  
  31. Das  wichtigste  sind  jedoch  die  Preferences,  dazu  dient  das Programm
  32. MultiResetPrefs.   Hier  kann man festlegen, was MultiReset alles tun soll.
  33. Wird  zum Zeitpunkt des Resets kein Prefsfile gefunden, so passiert absolut
  34. nichts, es sei denn, es sind andere Resethandler installiert.
  35.  
  36. Wenn  man  MultiResetPrefs  startet erscheint ein kleines Window, indem man
  37. alle notwendigen Einstellungen vornehmen kann:
  38.  
  39. >> Sfx <<
  40.  
  41. Hier  kann  man den kompletten Pfad eines IFF oder RAW-Samples angeben, der
  42. beim Reset abgespielt werden soll.
  43.  
  44. >> Gfx <<
  45.  
  46. Bestimmt  den  Namen einer IFF-Grafik, die angezeigt werden soll.  Ab OS3.0
  47. werden Datatypes unterstuetzt.  Wenn UserScreen nicht aktiviert ist, sollte
  48. die  Grafik die Anzahl der Bitplanes der Workbench nicht ueberschreiten und
  49. auch die Worchbenchfarben verwenden, da die Darstellung in einem Window auf
  50. der Workbench erfolgt.
  51.  
  52. >> Dos <<
  53.  
  54. Ein kompletter Dosbefehl, der vor den anderen Ausgaben ausgefuehrt wird.
  55.  
  56. >> Log <<
  57.  
  58. Hier  kann man eine Datei eintragen, in die ein Protokoll geschrieben wird.
  59. Aufgezeichnet  wird  der eigentliche Reset und der Testmodus (mit Datum und
  60. Zeit).
  61.  
  62. >> Misc - Nodelay <<
  63.  
  64. Hiermit   kann   man  eine  kurze  Wartezeit  vor  dem  eigentlichen  Reset
  65. unterdruecken.
  66.  
  67. >> Misc - Time <<
  68.  
  69. Hier kann man die Wartezeit von 0 bis 10 Sekunden frei definieren.
  70.  
  71. >> Misc - Norexx <<
  72.  
  73. Unterdrueckt  einen  Reset  via ARexx-Kommando.  Ebenfalls ist das Kommando
  74. REMOVE wirkungslos.
  75.  
  76. >> Misc - Workbench <<
  77.  
  78. Holt die Workbench nach vorn.
  79.  
  80. >> Misc - Userscreen <<
  81.  
  82. Das Bild wird auf einem eigenen Screen angezeigt.
  83.  
  84. >> Dos - Noopen <<
  85.  
  86. Ist  dieses  Gadget  aktiv, so werden Open()-Calls mit dem Modus NEWFILE in
  87. der Resetphase ignoriert.
  88.  
  89. >> Dos - Nowrite <<
  90.  
  91. Ist  dieses  Gadget  aktiv,  so  werden  alles Write() Aufrufe waehrend der
  92. Resetphase ignoriert.
  93.  
  94. >> Vectors - Cold <<
  95.  
  96. Wenn aktiv, wird der ColdCapture-Vector geloescht.
  97.  
  98. >> Vectors - Cool <<
  99.  
  100. Wenn aktiv, wird der CoolCapture-Vector geloescht.
  101.  
  102. >> Vectors - KickMem <<
  103.  
  104. Wenn aktiv, wird der KickMemPtr-Vector geloescht.
  105.  
  106. >> Vectors - KickTag <<
  107.  
  108. Wenn aktiv, wird der KickTagPtr-Vector geloescht.
  109.  
  110. >> PicPos <<
  111.  
  112. Hier  kann  man  die Position des ResetGrafik bestimmen.  Dazu oeffnet sich
  113. ein  Window  in  der Groesse der Grafik, die im Grafikpfad eingetragen ist.
  114. Man kann es nun beliebig verschieben.  Wenn das Closegadget beteatigt wird,
  115. werden die Koordinaten uebernommen.
  116.  
  117. >> VecPos <<
  118.  
  119. Hier  kann  man  die  Position des Windows bestimmen, in dem MultiReset die
  120. Vectoren  anzeigt  (nur beim Loeschen mindestens eines Vektors aktiv).  Die
  121. Vorgehensweis ist wie bei PicPos.
  122.  
  123. Wenn man in den entsprechenden X oder Y Positionen eine -1 eintraegt, dann
  124. wird die Darstellung in der entsprechenden Richtung zentriert.
  125.  
  126. Desweiteren  kann  man mit "SAVE" die Einstellungen sichern oder mit "LOAD"
  127. eine    alte    Einstellung   laden.    Der   Name   der   Prefsdatei   ist
  128. "ENV:MultiReset.prefs".     "TEST"   dient   zum   einfachen   Testen   der
  129. Einstellungen,  natuerlich  ohne Reset.  Das geht aber nur, wenn MultiReset
  130. im  Hintergrund aktiv ist.  Mit "RMVE" kann man MultiReset aus dem Speicher
  131. entfernen.  "QUIT" beendet schliesslich das Programm.
  132.  
  133. Will man MultiReset aus dem Speicher entfernen, so kann man es ganz einfach
  134. ein zweites mal aufrufen.
  135.  
  136. MultiReset  ist  Giftware.   Wem  das Programm gefaellt, so wuerde ich mich
  137. sehr ueber eine kleine Gabe freuen.  Wem es nicht gefaellt, der koennte mir
  138. zumindest  mitteilen,  warum nicht.  Weitere Anregungen oder Hinweise nehme
  139. ich  gerne  entgegen.   Aber  auch  Bugreports koennen sehr hilfreich sein,
  140. dieses kleine Programm zu verbessern.
  141.  
  142. History: V 1.3  - erste veroeffentlichte Version
  143.          V 1.4  - Bei den Filerequestern wird nun der aktuelle Pfad der
  144.                   aktiven Grafik oder des Samples als Default benutzt
  145.          V 1.5  - interne Version
  146.          V 1.6  - Windowposition der Prefs wird gesichert  
  147.          V 1.7  - Positionierung der Fenster jetzt korrekt
  148.                 - Logfilefunktion
  149.                 - Verbieten von Open() und Write() waehrend der Resetphase
  150.          V 1.71 - Bug im Gadgethandling behoben
  151.          V 1.8  - Keine Pause nach dem Abspielen des Samples
  152.          V 1.9  - Preferences werden jetzt auch in ENVARC: gesichert
  153.                 - Rexxport
  154.          V 2.0  - MUI-Oberflaeche fuer die Prefs
  155.          V 2.01 - ARexx-Kommando REMOVE
  156.                 - Gadgets sind erst nach loslassen aktiv :)
  157.          V 2.02 - variable Wartezeit (0-10s)
  158.                 - Prefs statt in ENV: in ENVARC:
  159.          V 3.0ß - Prefslayout geaendert
  160.                 - Datatype-Unterstuetzung fuer Grafik (OS3.0+)
  161.                 - Mauszeiger wird bei Reset deaktiviert
  162.  
  163. Zu erreichen bin ich:
  164.  
  165.    E-Mail    : f.fenn@cross.berlinet.de
  166.    Sackpost  : Frank Fenn, Raabestrasse 7, Berlin 10405
  167.    Teflon    : (030) 39979430 (von 07:00-15:30)
  168.  
  169. Danksagungen
  170.  
  171.    Stefan Stuntz          - fuer das MUI(3.1)-Paket
  172.    Wouter van Oortmerssen - fuer den "genialen" E-Compiler
  173.    Mario Cattaneo         - fuer seine umfangreichen Bugreports und Hinweise
  174.